home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / mg108.zip / MAILGATE.DOC < prev    next >
Text File  |  1995-11-14  |  29KB  |  844 lines

  1.                      MailGate 1.08
  2.  
  3.                Copyright (c) Dave Hamilton 1995
  4.  
  5.  
  6.  
  7.  
  8.                         WARNING
  9.  
  10.     This is shareware. It is not guaranteed to do anything, or
  11.     to not do anything. Use it at your own risk.
  12.  
  13.     This software is not free. If you don't want to register it,
  14.     please remove it from your system or give it to someone else to
  15.     try.
  16.  
  17.     See the section on Registration at the end of this document.
  18.  
  19.  
  20.                   Acknowledgements
  21.  
  22. OS/2, Warp, and IBM's version of SENDMAIL are copyright (c) IBM Corp.
  23. Msgapi32.dll and Squish are copyright (c) SCI Communications, and are
  24.     trademarks of Lanius Corporation.
  25. FleetStreet is copyright (c) by Michael Hohner and Harry Herrmannsdorfer.
  26. MailMan is copyright (c) by Ron Bemis
  27.  
  28. Note:
  29.  
  30.     This product was originally named MailMan. Turns out Ron Bemis
  31.     had written a product named MailMan a long time ago, so with
  32.     apologies to Ron for stepping on his toes, we now release
  33.     MailGate version 1.07.
  34.  
  35. Many thanks go to:
  36.  
  37.     - Niel Kempson, who gets out his email after a walk in the Alps
  38.  
  39.     - Pete Norloff, for his kind, thoughtful, and thorough feedback
  40.  
  41.     - Eric Allman, for giving us Sendmail and still hanging in there
  42.         in comp.mail.sendmail
  43.  
  44.  
  45.  
  46.  
  47.  
  48. 1.1 What is MailGate ?
  49.  
  50.     MailGate allows multi-user mail on an OS/2 system or LAN.
  51.  
  52.     MailGate is a command-line program that acts as an interface between
  53.     OS/2's Sendmail and your BBS Message Base. Typically, you set up
  54.     one Message area for Email. Your users can then send and receive
  55.     internet mail via this area. MailGate retrieves incoming mail that
  56.     has been received by SENDMAIL, confirms that the addresee exists
  57.     in your user base, and places the mail in this area, addressed
  58.     to this user. MailGate can also scan outgoing mail out of this area
  59.     and send it out of your system via SENDMAIL.
  60.  
  61. 1.2    Installation
  62.  
  63.     Create a directory for MailGate (typically C:\MM ) and place
  64.     the files from the .zip file in that directory.
  65.  
  66.     If you don't already have msgapi32.dll on your system, copy
  67.     the one in this distribution to a directory in your LIB path.
  68.  
  69.     Create MailGate's User file. If you're using Maximus as a BBS,
  70.     you can use the makeuf.exe utility included with MailGate. Decide
  71.     where you want the user file to be (usually in your \mm directory
  72.     or your \max directory) and run the utility, specifying the path
  73.     to your USER.BBS file, and the path to where you want the user 
  74.     file. Example:
  75.  
  76.         makeuf \Max\ \MG\
  77.  
  78.     If you don't want makeuf to create aliases in the UserFile
  79.     from the alias fields in your User.BBS file, specify the
  80.     commandline switch -noalias. Example
  81.  
  82.         makeuf \Max\ \MG\ -noalias
  83.  
  84.     If you use makeuf, you should be aware that MailGate supports
  85.     one-word user names as well as firstname.lastname@yourdomain.
  86.     MailGate will use the Alias field from USER.BBS as a mailing
  87.     alias. You can have Aliases turned off in Max but still use
  88.     them for email addresses. If you use the -noalias switch when
  89.     running makeuf, aliases will not be copied from your User.BBS
  90.     file. However, you can still use aliases by manually entering
  91.     users into the UserFile.
  92.  
  93.     If you don't use Max, you can create the user file with any
  94.     text editor.
  95.  
  96.     The file must be called USERFILE (you don't have to use upper case)
  97.     and you must specify where it is located in your MailGate.Cfg
  98.     file.
  99.  
  100.     The format of the file is:
  101.  
  102.         Firstname Lastname [, alias]
  103.  
  104.     Note that the alias is optional, but if you use it, MailGate will
  105.     look for one-word mail recipients as aliases.
  106.  
  107.     Copy Sample.Cfg to MailGate.Cfg
  108.  
  109.     Edit MailGate.Cfg file to suit your needs. Items in the config file
  110.     are fully documented. Any line that begins with a hash (#) is
  111.     a comment. MailGate ignores these and blank lines.
  112.  
  113.     Add the line:
  114.  
  115.         SET MAILGATE=\MG\
  116.  
  117.     (or whatever MailGate's home directory is) to your CONFIG.SYS.
  118.     MailGate looks for the environment variable MAILGATE to find its
  119.     configuration file. If you don't set this variable, you can
  120.     always run MailGate in its own directory.
  121.  
  122.     Copy MailGate.EXE to a directory in your PATH.
  123.  
  124.     AFTER you have set up MailGate.Cfg to suit your needs, compile
  125.     your user data base. Type:
  126.  
  127.         MAKEIDX
  128.  
  129.     MailGate determines where to put the compiled files from your
  130.     configuration. If you have specified either a UserFile location
  131.     or a User.BBS location, MailGate places the indexed files in
  132.     the first of those locations it encounters when reading MailGate.Cfg.
  133.  
  134.     On startup, MailGate uses the same approach to locate its indexed
  135.     files. If it finds them, it uses them.
  136.  
  137.     
  138.  
  139. 1.2 How Does it Work ?
  140.  
  141.     MailGate, if run without any commands or command-line switches,
  142.     will simply report any mail that is sitting in SENDMAIL's inbound
  143.     directory - who it's from and who it's to.
  144.  
  145.     When run with the -in switch,
  146.  
  147.         MailGate -in
  148.  
  149.     MailGate reads all the mail in SENDMAIL's server inbox, converts
  150.     it to your message base format, either Squish or *.MSG, and places
  151.     the mail in your message area for your users to read.
  152.  
  153.     When run with the -out switch,
  154.  
  155.         MailGate -out
  156.  
  157.     MailGate scans the Email message base defined in MailGate.Cfg for
  158.     outgoing mail. If any messages are found, they are sent via
  159.     SENDMAIL.
  160.  
  161. 1.3    Other Command Line Switches
  162.  
  163.     -v    Verbose mode - MailGate will display a running commentary on
  164.         everything it does.
  165.  
  166.     -l    Logging - MailGate will create the file MailGate.Log in its home
  167.         directory. This is useful for running MailGate as a background
  168.         or CRON-scheduled task.
  169.  
  170.     -po Peek at Outbound - MailGate will scan your Email area rapidly,
  171.         not reading messages but counting messages that will be
  172.         scanned out. This lets you know if there is any mail to
  173.         go out without running MailGate -out
  174.  
  175.     -pi    Peek at Inbound - This will give you a quick report of mail
  176.         that is sitting in SENDMAIL's inbox, waiting to be tossed
  177.         into your Email area.
  178.  
  179.     -pq Peek at Queue - At the time of this writing, IBM has not
  180.         implemented an outbound queue listing service in SENDMAIL.
  181.         When you use this option, MailGate lists messages that have
  182.         been passed to SENDMAIL but have not yet been sent by
  183.         SENDMAIL. This could be an indication of a problem with
  184.         your ISP's routing, or with the recipient's routing.
  185.  
  186.         You can concatenate the -p options together:
  187.  
  188.             -pioq
  189.  
  190.     -r    Reset the timestamp. This will set the last-looked time
  191.         to zero, so that all incoming mail will be checked when
  192.         you next look or scan.
  193.  
  194. 1.4    Without Command Line Switches
  195.  
  196.     Just type MailGate ( or MailGate -v ) for a report on what mail is
  197.     pending.
  198.  
  199. 2.0 About SENDMAIL
  200.  
  201.     When the internet access kit is installed, it defaults to using
  202.     the SMTP (Simple-Mail-Transport-Protocol) protocol for receiving
  203.     mail, and POP (Post-Office-Protocol) for sending it. POP is a
  204.     single-user protocol. Users must use a login name and password
  205.     to access their mail.
  206.  
  207.     There are two widely distributed versions of SENDMAIL for OS/2.
  208.     One works with Ultimail, the other with the older LaMail. These
  209.     versions behave slightly differently. If you use either of these
  210.     programs, you must have a MailStyle=Ultimail, or MailStyle=LaMail
  211.     line in your MailGate.Cfg file for MailGate to interface completely
  212.     with your setup. If you don't put this line in your config file,
  213.     MailGate will still appear to work correctly, but information
  214.     created by SENDMAIL that is not obvious will not be correctly
  215.     updated.
  216.  
  217.     You need to set up SENDMAIL to use SMTP for both sending and 
  218.     receiving. If you're not sure how to do this, an excellent
  219.     source of information is contained in the file umsmtp03.zip
  220.     by Niel Kempson, available on wellknown internet sites, including
  221.     this author's site ( ftp.proven.com ). This file contains
  222.     in-depth documentation of the Warp release of SENDMAIL, as well
  223.     as sample SENDMAIL configuration files.
  224.  
  225.     If you really want to know everything there is to know about
  226.     SENDMAIL, read Sendmail by Bryan Costales et al, O'Reilly &
  227.     Associates.
  228.  
  229.     We have seen many systems that started out as a single OS/2
  230.     multi-user machine, and have had workstations added on a
  231.     network later. If your system is on a network, we strongly
  232.     urge you to consider using one machine for your BBS and
  233.     another for your internet mail and news, as a gateway. This
  234.     gives you more flexibility in your mailing setup and significantly
  235.     reduces competition for resources on your main machine. IBM's
  236.     version of SENDMAIL is extremely well suited to local networking
  237.     and distributed processing. Just an observation...
  238.  
  239.  
  240. 3.0    The MailGate.CFG File
  241.  
  242.     MailGate requires some information to run, which is contained in
  243.     the MailGate.Cfg file. A well-documented example is contained
  244.     in the distribution.
  245.  
  246.     You must edit this file using any OS/2 text editor (E.EXE will do)
  247.     and specify some paths and options to suit your system.
  248.  
  249. 3.1 MyAddr
  250.  
  251.     This line contains your FidoNet address, which you will have if
  252.     you are running a BBS. MailGate supports 4-D addresses. Example:
  253.  
  254.         MyAddr=1:229/622.2
  255.  
  256. 3.2    MyOrg
  257.  
  258.     This is the name of your organization. It is included in outbound
  259.     messages in the standard Organization: header. Example:
  260.  
  261.         MyOrg=Proven Systems
  262.  
  263. 3.3 MyDomain
  264.  
  265.     This is the full domain name of your mail server. If your mailing
  266.     address is george@hoochie.com, the domain name will be hoochie.com
  267.     Example:
  268.  
  269.         MyDomain=proven.com
  270.  
  271.     When processing inbound mail, MailGate only processes messages destined
  272.     for this domain, or for no domain (local messages). MailGate ignores
  273.     messages addressed to users with other email domains.
  274.  
  275. 3.4 LogFile
  276.  
  277.     Logging is optional. If you want MailGate to keep a log, you must
  278.     run it with the -l switch. If you do, this specifies the directory
  279.     path where the logfile will go. It does not contain the name of
  280.     the log file itself - MailGate will create that - it just needs to
  281.     know where you want it put. Example:
  282.  
  283.         LogFile=c:\MG\
  284.  
  285. 3.5 ServerInBox
  286.  
  287.     This is the pathway to SENDMAIL's inbox. MailGate will check this
  288.     when run without switches, or with the -i switch, for incoming
  289.     mail. Example:
  290.  
  291.         ServerInBox=c:\tcpip\umail\server\inbox\
  292.  
  293. 3.6    ServerOutBox
  294.  
  295.     This is the pathway to SENDMAIL's outgoing spool queue. MailGate
  296.     will ONLY access this path if you specify Send=Queue for the
  297.     sending method. Whether you specify Queue sending or not, it is
  298.     a good idea to declare this path. You will read several warning
  299.     messages throughout this document about using the Queue method
  300.     on a network. Please don't. Use the Pipe method instead.
  301.     Example:
  302.  
  303.         ServerOutBox=c:\tcpip\etc\mqueue\
  304.  
  305. 3.7    EmailArea
  306.  
  307.     This is the path to your Email BBS area. If your message base
  308.     is *.MSG (shudder) this line will be the path to where the
  309.     messages are stored. If this is a Squish message base, it is
  310.     the path and name of the message area. If this is a Squish area,
  311.     put a $ at the end of the line.
  312.  
  313.     Example for a *.MSG area:
  314.  
  315.         EmailArea=c:\Max\Msg\Email\
  316.  
  317.     Example for a Squish area:
  318.  
  319.         EmailArea=c:\Max\Msg\Email $
  320.  
  321. 3.8    BadArea
  322.  
  323.     This is the path to your BBS bad files area, usually called 
  324.     BAD_MGS. Optionally, you can have MailGate toss bad messages or
  325.     messages to users unknown to you into this area. The syntax is
  326.     the same as the Email area. If it's a *.MSG area, specify the
  327.     directory. If it's a Squish base, specify the path and name, and
  328.     put a $ at the end of the line.
  329.  
  330.     Example for a *.MSG area:
  331.  
  332.         BadArea=c:\Max\Msg\Bad\
  333.  
  334.     Example for a Squish area:
  335.  
  336.         BadArea=c:\Max\Msg\Bad $
  337.  
  338.     MailGate will only toss messages here if the TossBadMsgs line 
  339.     IS specified and the BounceBadMsgs line is NOT specified.
  340.  
  341. 3.9    FileAttachArea
  342.  
  343.     This line specifies the directory where MailGate should deposit
  344.     binary files it finds encapsulated in your mail messages. MailGate
  345.     automatically detects and decodes UUencoded files. 
  346.  
  347.     You can instruct MailGate to totally ignore encapsulated binary
  348.     files using the IgnoreFileAttach line. This only applies to
  349.     inbound messages. You can still send binary files by attaching
  350.     them to outbound messages, and MailGate will UUencode them.
  351.     Example:
  352.  
  353.         FileAttachArea=c:\Max\File\Uncheck
  354.  
  355. 3.10 UserFile
  356.  
  357.     This is the path, not including the filename, of where MailGate's
  358.     UserFile is located. Example:
  359.  
  360.         UserFile=c:\MG\
  361.  
  362. 3.11 Max2UserBBS
  363.  
  364.     If you use Maximus 2.x or 3.00, you can have MailGate search your
  365.     User.BBS file for users. In this case, you don't have to run MAKEUF
  366.     every time you make changes to your user base. If you are specifying
  367.     both UserFile and UserBBS, MailGate will search in both files
  368.     starting with whichever you specify first. Note that you can turn
  369.     off searching-by-alias using the UseBBSAlias=No line. This will
  370.     cause MailGate to ignore the alias field in your User.BBS file,
  371.     but it will still search for aliases in your UserFile.
  372.  
  373.     Example:
  374.  
  375.         Max2UserBBS=c:\Max\
  376.  
  377. 3.12 TossBadMsgs
  378.  
  379.     You can specify TossBadMsgs, BounceBadMsgs, or neither. If you
  380.     specify TossBadMsgs, MailGate will put mail for unknown users
  381.     in the area specified by BadArea.
  382.  
  383. 3.13 BounceBadMsgs
  384.  
  385.     If you specify BounceBadMsgs, MailGate will return to sender any
  386.     mail for which it cannot locate a valid, legal user. If you
  387.     don't specify either TossBadMsgs or BounceBadMsgs, MailGate will
  388.     skip such messages.
  389.  
  390. 3.14 Send
  391.  
  392.     There are currently two methods of sending mail: Pipe or Queue.
  393.     If your machine is on a network and the SENDMAIL directories
  394.     are on another machine, you MUST specify Pipe.
  395.  
  396.     Why the choices? If you specify Pipe, MailGate sends outgoing
  397.     messages by calling SENDMAIL, and pipes the messages to SENDMAIL.
  398.     This is not particularly fast, but it is very reliable. If 
  399.     SENDMAIL cannot connect with a destination host, it will enqueue
  400.     the message for later transmission by itself, and retry at a
  401.     later time to send the message.
  402.  
  403.     If you are on a single machine, you can specify Queue, in which
  404.     case MailGate will create the appropriate files in SENDMAIL's
  405.     outbound queue. SENDMAIL checks its outbound queue periodically,
  406.     and if there is anything in it, sends out the messages. This
  407.     method is ver fast in terms of getting the mail out of the
  408.     BBS base, and overall it is faster than piping the messages
  409.     one at a time.
  410.  
  411.     Examples:
  412.  
  413.         Send=Queue
  414.         Send=Pipe
  415.  
  416. 3.15 HideAHeaders
  417.  
  418.     RFC822 mail has a header and a body. The header is classified
  419.     by MailGate into two areas, A and B. Info contained in the A
  420.     part is To:, From:, Full-Name:, and Return-Path:. Info contained
  421.     in the B part is everything else that comes in in a header.
  422.     MailGate ALWAYS hides this information in the hidden control area
  423.     of each message, so this keyword is invoked by default.
  424.  
  425. 3.16 KeepAHeaders
  426.  
  427.     If you want to include A-Header information in your message body
  428.     so you can read it, specify this keyword in your .cfg file. Example:
  429.  
  430.         KeepAHeaders
  431.  
  432. 3.17 HideBHeaders
  433.  
  434.     Non-essential header information can also be stored in the hidden
  435.     area if you specify HideBHeaders. Most message editors have some
  436.     way of showing you the hidden information on demand. This is the
  437.     default choice for MailGate. Example:
  438.  
  439.         HideBHeaders
  440.  
  441. 3.18 KeepBHeaders
  442.  
  443.     If you want the Class B header information to show up in your
  444.     messages, specify this keyword. Example:
  445.  
  446.         KeepBHeaders
  447.  
  448. 3.19 SkipBHeaders
  449.  
  450.     If you're not interested in keeping the non-essential header
  451.     information at all, specify this keyword to instruct MailGate
  452.     to just skip over it. Example:
  453.  
  454.         SkipBHeaders
  455.  
  456. 3.20 NoOutboundKludges
  457.  
  458.     If you are using (recommended) a Local area for your email
  459.     message base, you don't need to worry about this option. If
  460.     you are using (not recommended) an EchoArea for your email,
  461.     Fido programs normally place a hidden PATH kludge after the
  462.     tearline (origin line). These will appear on an internet
  463.     mail editor. To have them ignored when scanning messages OUT
  464.     of your message base, include this line in your MailGate.Cfg:
  465.  
  466.         NoOutboundKludges
  467.  
  468. 3.21 NoOutboundSeenbys
  469.  
  470.     As in the situation above (section 3.20), Fidonet Echo areas
  471.     have a hidden line at the end of a message with a list of
  472.     systems that have seen the message. You should never remove
  473.     this line from incoming or existing messages. However, when
  474.     scanning them out to Email, you can direct MailGate to omit
  475.     this line by including in your MailGate.Cfg:
  476.  
  477.         NoOutboundSeenbys
  478.  
  479. 3.22 TextWidth
  480.  
  481.     Well-written Fido message editors allow the text to free flow
  482.     except for paragraph breaks. This lets editors with varying
  483.     screen widths format text in readable form. It is convention
  484.     however in internet mail to place carriage returns at the end
  485.     of lines. By default, MailGate sets the right margin at 70
  486.     characters, and word-wraps text that would exceed that limit
  487.     by starting a new line. You can set the TextWidth to any number
  488.     of columns from 40 to 80, but 65-75 are recommended. Example:
  489.  
  490.         TextWidth=70
  491.  
  492. 3.23 UseBBSAlias
  493.  
  494.     By default, MailGate will search your User.BBS file looking for
  495.     either a match in the alias field for one-word recipients, or
  496.     a match in the username field for multiple-word recipients. To
  497.     have MailGate ignore the alias field altogether, specify:
  498.  
  499.         UseBBSAlias=No
  500.  
  501.     When creating a UserFile using the utility Makeuf, use the 
  502.     commandline switch -noalias.
  503.  
  504. 3.24 MailStyle
  505.  
  506.     If your system is set up for LaMail, specify:
  507.  
  508.         MailStyle=LaMail
  509.  
  510.     If your system is set up for Ultimail, specify:
  511.  
  512.         MailStyle=Ultimail
  513.  
  514.     If you are not set up for either LaMail or Ultimail, leave
  515.     this specification line out of your .cfg file. Other interfaces
  516.     may be supported in the future.
  517.  
  518.     If you are using the Warp Internet Access Kit, install Ultimail
  519.     even if you don't plan to use it. This will ensure that SENDMAIL
  520.     is creating the .UML files. Then, specify:
  521.  
  522.         MailStyle=Ultimail
  523.  
  524. 3.25 UseTime
  525.  
  526.     If you specify a single line with:
  527.  
  528.         UseTime
  529.  
  530.     MailGate will remember when it last scanned mail in. On systems
  531.     that toss or bounce mail to unknown users, this will not be
  532.     relevent, but for those who keep mail to read with some other
  533.     mailer, it can speed up your processing. When MailGate checks
  534.     for inbound mail, if this line has been specified, it only
  535.     checks mail that has arrived since the last time it looked.
  536.  
  537.     If you want MailGate to re-scan older mail, you can either leave
  538.     this line out of your configuration, or you can reset the
  539.     timer by running:
  540.  
  541.         MailGate -r
  542.  
  543.     This will have the one-time effect of setting the last-looked
  544.     timer to zero which will cause MailGate to scan all mail
  545.     in the inbox.
  546.  
  547. 3.26 NoLocalFlag
  548.  
  549.     If you specify a single line with
  550.  
  551.         NoLocalFlag
  552.  
  553.     MailGate will not set the MSGLOCAL bit in your Squish/MSG base
  554.     when it tosses incoming mail. By default, this bit is set, but
  555.     it causes problems with some tossers/scanners.
  556.  
  557. 4.0    Sending Email
  558.  
  559.     We suggest setting up your Email area as a Local file area. This
  560.     way, when Squish scans, it will ignore this area.
  561.  
  562.     When a user wants to send email, she goes to this area via whatever
  563.     menu paths exist on your BBS and enters a new message. For her own
  564.     name (From:) she can either put Firstame Lastname, or she can enter
  565.     Firstname.Lastname@your.domain, or she can enter alias@your.domain.
  566.  
  567.     In the To: line, the user enters the email address of the recipient
  568.     of the message. If your message editor does not have enough room
  569.     to enter the email address, 
  570.  
  571.         Leave the To: line blank, and on the first line of the 
  572.         message body, enter:
  573.  
  574.             To:person@destination.address
  575.  
  576.         Leave the next line blank. Then, enter your message.
  577.  
  578.     If you are using a full-featured editor such as FleetStreet,
  579.     you can set it up so that when you are in the Email area,
  580.     your personal email address is used for the From: field.
  581.  
  582.     If your editor insists on having something in the To: field,
  583.     rather than leaving it blank, just put in something like 'list'.
  584.     It will be replaced by the real destination found on the first
  585.     line of the body when MailGate scans it out.
  586.  
  587.     Multiple Recipients:
  588.  
  589.     MailGate can handle sending a message to multiple recipients.
  590.     You can have multiple addresses on the To: line of the
  591.     body like this:
  592.  
  593.         To: harry@armes.com,
  594.             sam@quicksilver.com
  595.  
  596.     Just be sure that there are no blank lines until after the
  597.     addressing. The To: must be on the first line of the body.
  598.     Place a comma at the end of every line but the last one,
  599.     to tell MailGate that there are more lines.
  600.  
  601.     There must be at least one blank line after the addresses.
  602.  
  603.     Carbon Copies:
  604.  
  605.     MailGate can send carbon copies of a message to you or other
  606.     users. Specify carbon copies like this:
  607.  
  608.         To: harry@armes.com,
  609.             sam@quicksilver.com
  610.         Cc: daveh@proven.com
  611.  
  612.     As above, there must be no blank lines until after the addresses.
  613.  
  614.     Blind Carbons:
  615.  
  616.     RFC822 defines a blind-carbon copy field, and MailGate supports
  617.     it for the sake of convention. You would use this when sending
  618.     mail to a host where the message is send to a list of users,
  619.     and you know the name of the list. The receiving host will
  620.     take care of copying in everyone on its list. Example:
  621.  
  622.         To: harry@armes.com,
  623.             sam@quicksilver.com
  624.         Bcc: userlist@tohost.com
  625.  
  626. 5.0    Name-Alias Translations
  627.  
  628.     When sending mail, MailGate looks to see how many words are in
  629.     the sender's name. If there are more than one, MailGate considers
  630.     this to be the sender's BBS name. It then looks for an alias in
  631.     the UserFile, and if it finds one, uses alias@your.domain for the
  632.     sending address and return path. If MailGate finds a multiple-word
  633.     name but no corresponding alias, it uses first.last@your.domain as
  634.     the email address.
  635.  
  636.     If only one word is found in the sender's name, it is considered to
  637.     be an alias, but it is verified. MailGate then uses alias@your.domain
  638.     as the sender's address.
  639.  
  640.     When receiving mail, MailGate counts the number of words in the
  641.     recipient's name. If it finds only one, it looks for an alias in
  642.     the UserFile. If it finds one, it translates the alias to the
  643.     user's registered BBS name and files the message under that name
  644.     so that the BBS itself can recognize it. If MailGate finds multiple
  645.     words for the recipient's name, it considers them to be parts of
  646.     a BBS name, parses them out, and looks in the UserFile for
  647.     verification. If it finds the name, it saves the message.
  648.  
  649.     If neither a valid name nor a valid alias are found, MailGate
  650.     designates the message as Bad. It then behaves according to its
  651.     configuration file.
  652.  
  653.     If you have specified BouceBadMsgs, MailGate returns the message to
  654.     its sender.
  655.  
  656.     If you have specified TossBadMsgs, MailGate places the message in
  657.     the area you have defined as BadArea.
  658.  
  659.     If you have not specified either TossBadMsgs or BounceBadMsgs, the
  660.     message is left untouched in SENDMAIL's inbox.
  661.  
  662.     If you have logging turned on ( -l switch ) when MailGate is run,
  663.     a record of the action taken on received messages is kept.
  664.  
  665.  
  666. 6.0 How to reach us
  667.  
  668.     For problem reports, suggestions for future releases, and even
  669.     good news, you can reach us at:
  670.  
  671.         mailgate@proven.com
  672.  
  673.     or you can send Fido Netmail to Mail Gate at 1:229/622.
  674.  
  675. 7.0 Current Versions
  676.  
  677.     The current release is in mg108.zip.
  678.  
  679.     You can FREQ the current release from 1:229/622 using the
  680.     magic name MAILGATE, or you can download it from hobbes or:
  681.  
  682.         ftp.proven.com
  683.  
  684.     in the Os2/Inet directory.
  685.  
  686.  
  687. 8.0 The makeidx.exe utility
  688.  
  689.     Beginning with version 0.9, MailGate uses a compiled index
  690.     created from your User.BBS and/or UserFile. MAKEIDX scans
  691.     your MailGate.Cfg to determine which of these files you use,
  692.     and whether or not you permit the User.BBS alias field to
  693.     be used. It then creates the index files.
  694.  
  695.     Note that even if you don't allow your User.BBS alias field
  696.     to be used, aliases are still permitted and searched for in
  697.     your UserFile, allowing you to set up aliases for you and your
  698.     staff, but not for your users, or to create aliases for some
  699.     users in such case that you might be using the alias field
  700.     in your User.BBS for some other thing.
  701.  
  702.     Once the indexed files are compiled, MailGate automatically 
  703.     detects them and uses them.
  704.  
  705.     This process reduces the time for MailGate to validate a user
  706.     dramatically.
  707.  
  708. 9.0 The fu.exe utility
  709.  
  710.     You can lookup user names and/or aliases using the fu utility.
  711.     FU searches your files in the same sequence as MailGate does.
  712.     By default, fu expects as an argument either a name or an alias,
  713.     and returns the name for that user. Example:
  714.  
  715.         fu daveh
  716.            daveh is Dave Hamilton
  717.  
  718.     If you use the -a switch anywhere in the command line, fu will
  719.     return an alias from either a name or alias:
  720.  
  721.         fu dave hamilton -a
  722.            dave hamilton is daveh
  723.  
  724.     The -v switch can provide more information IF you have used a
  725.     User.BBS file to create your indexed files. In this case, pointers
  726.     to the User.BBS entries are maintained, and fu has access to
  727.     all the information contained about the user in your system.
  728.     Try looking up a user with the -v switch for a demonstration.
  729.  
  730.     This was originally developed for testing purposes, but it has
  731.     proven to be handy. We just thought we'd share it with you. Even
  732.     if you decide not to register MailGate, please keep it with our
  733.     compliments.
  734.  
  735. 10.0 Registration
  736.  
  737.     If you wish to use MailGate, please consider registering it.
  738.     Registration is $25. US. Registration will entitle you to
  739.     support responses and future upgrades. You can register either
  740.     by mail or through BMT Micro using pretty well any payment
  741.     method you can think of.
  742.  
  743.     Registering by Mail:
  744.  
  745.     Please print the form REGISTER.FRM and send it with your check
  746.     to:
  747.  
  748.         Dave Hamilton
  749.         220 Arthur Street
  750.         Newcastle, ON, CANADA, L1B 1L8
  751.  
  752.     We will send you a registration name and key via email, snailmail,
  753.     or netmail. Please indicate your choice on the registration form.
  754.  
  755.  
  756.     Registering with BMT Micro:
  757.  
  758.  
  759.                   Mail Orders To: BMT Micro
  760.                                   PO Box 15016
  761.                                   Wilmington, NC 28408
  762.                                   U.S.A.
  763.  
  764.                     Voice Orders: 9:00am - 7:00pm EST (-5 GMT)
  765.                                   (800) 414-4268 (orders only)
  766.                                   (910) 791-7052
  767.  
  768.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  769.  
  770.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  771.                                   (910) 799-0923  Direct 28.8K line
  772.  
  773.      Ordering and general ordering questions:
  774.                          Via AOL: bmtmicro
  775.                   via Compuserve: Thomas Bradford, 74031,307
  776.                     via Internet: thomas.bradford@bmtmicro.com
  777.  
  778.      We accept Visa, Mastercard, Discover, American Express, Money Order,
  779.      Cashiers Check, Personal Check.  Please do not send cash in the mail.
  780.      Personal checks are subject to clearance.
  781.  
  782.      Each copy of the package includes the latest version of MailGate.
  783.  
  784.  
  785.      Name ________________________________________________________________
  786.  
  787.      Address _____________________________________________________________
  788.  
  789.              _____________________________________________________________
  790.  
  791.      Phone _______________________________________________________________
  792.  
  793.  
  794.      Product                    Quantity Price  Number of copies
  795.      _________________________  ______________  ________________
  796.  
  797.                                               x ____________ = + $ _______
  798.  
  799.                                               x ____________ = + $ _______
  800.  
  801.                                               x ____________ = + $ _______
  802.  
  803.  
  804.      Product is shipped on 3.5" diskette.
  805.  
  806.  
  807.      Shipping and Handling (no quantity limit):                + $ _______
  808.  
  809.        Email - Subject to Credit Card Verification     Free
  810.        Fax - Subject to Credit Card Verification..     Free
  811.        Worldwide 1st Class .......................     Free
  812.        2nd Day Priority, USA Only ................ $   4.00 US
  813.        US Postal Service International Express
  814.          (Including Canada and Mexico), allow up to
  815.          7-10 days ............................... $  20.00 US
  816.        Airborne Select Delivery  (USA Only)        $   7.00 US
  817.        FedEx Overnight, USA Only (delivery by
  818.          3:00 pm the following day) .............. $  15.00 US
  819.        FedEx Europe/Japan (guaranteed delivery
  820.          within 3 days) .......................... $  30.00 US
  821.  
  822.        Worldwide, any business with a valid FedEx account can
  823.        charge shipping to their FedEx account and pay no
  824.        shipping charges to us.
  825.  
  826.      Total:                                                      $ _______
  827.  
  828.  
  829.      For credit card payment only                                   
  830.      
  831.       Circle one: VISA / Master / Discover / American Express        
  832.      
  833.       Credit card number: _____________________________________________ 
  834.  
  835.       Expiration date: ________________________________________________
  836.  
  837.       Authorization signature: ________________________________________ 
  838.  
  839.  
  840.  
  841. Happy Computing...
  842.  
  843. dave hamilton
  844.